[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
MODIFYING THE LIST CHARACTERISTICS

     The interface section of the ListTTT5 unit includes a variable LTTT of
     type L_Display. The elements of the LTTT record have Toolkit defaults
     and do not need to be altered. However, the programmer can change the
     look and feel of the menu by changing any element(s) of LTTT.

     LTTT is defined as follows:

     L_DISPLAY =
     RECORD
          X           : BYTE;
          Y           : BYTE;
          LEFTSIDE    : BOOLEAN;
          LINES       : BYTE;
          TOPICWIDTH  : BYTE;
          ALLOWESC    : BOOLEAN;
          BOXTYPE     : BYTE;
          BOXFCOL     : BYTE;
          BOXBCOL     : BYTE;
          CAPFCOL     : BYTE;
          BACCOL      : BYTE;
          NORFCOL     : BYTE;
          HIFCOL      : BYTE;
          HIBCOL      : BYTE;
          LEFTCHAR    : CHAR;
          RIGHTCHAR   : CHAR;
          TOGGLECHAR  : CHAR;
          ALLOWTOGGLE : BOOLEAN;
          END_CHARS   : SET OF CHAR;
          SELECT_CHARS: SET_OF_CHAR;
          HOOK        : LIST_HOOK; {VER 5.0 ONLY}
     END;

     X - the X coordinate of the top corner of the menu. The coordinate
     refers to the left corner if LeftSide is true, or the right side if
     LeftSide is false. If TopX is set to 0 then the list is centered on
     the screen. Default: 0.

     Y - the Y coordinate of the top line of the menu. If TopY is set to 0
     then the menu starts on the seventh line of the screen. Default: 0.

     LeftSide - this boolean variable indicates if the TopX and TopY
     coordinates refer to the left or right corner. Default: true.

     Lines - indicates the number of topics to display in the window. If it
     is set to 0, the unit sets it to an appropriate value based on the
     length of the list and the number of available display lines. Default:
     0.

     TopicWidth - this indicates the width of the topics in the menu. If it
     is set to 0, the unit automatically computes the width based on the
     longest topic in the list. Default: 0.

     AllowEsc - a boolean variable to indicate whether the user may escape
     out of the list by pressing the ESC key. Default: true.

     BoxType - this byte variable indicates which box border to use around
     the menus. The codes are the same as for the box related commands in
     the FastTTT5 unit, e.g. 0 no border, 1 single, 2 double, etc. Default:
     1.

     BoxFCol - the foreground color of the box border. Default: yellow for
     color systems, white for monochrome.

     BoxBCol - the background color of the box border. Default: blue for
     color systems, black for monochrome.

     CapFCol -  the foreground color of the first capital letter - a user
     can select a topic by pressing the first capital letter of a topic.
     Default: white.

     BacCol - the main background color of the menu. Default: blue for
     color systems, black for monochrome.

     NorFCol - the foreground color of the normal menu topics. Default:
     lightgray.

     HiFCol - the foreground color of the selected menu topic. Default:
     white.

     HiBCol - the background color of the selected menu topic. Default: red
     for color systems, black for monochrome.

     LeftChar - the character that is used to point to the left side of the
     topic highlight bar. Default: the right arrow, chr(16).

     RightChar - the character that is used to point to the right of the
     topic highlight bar. Default: the left arrow, chr(17).

     ToggleChar - if the user is allowed to select multiple characters, the
     selected topics are marked with a ToggleChar to the left of the topic
     description. Default: tick mark, chr(251).

     AllowToggle - set to true to allow the user to select more than one
     topic. Default: true.

     End_Chars - this is a variable of type "set of char". It can include
     one or more characters that will terminate or end the list procedure.
     Default: Enter, [#13]. For example, to activate the keys F10 and Alt-X
     as terminate characters then:
          END_CHARS := [#196,#173];

     Select_Chars - this is a variable of type "set of char". It can include
     one or more characters that the user can use to select a topic, when
     the AllowToggle is set to true. Default: space, [' '].

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson